<!--

    Copyright (c) 2005, 2018 Oracle and/or its affiliates. All rights reserved.
    Portions Copyright &#169; [2017-2020] Payara Foundation and/or affiliates.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->

<p><a id="task-gmscluster" name="task-gmscluster"></a><a id="GHCLU00079" name="GHCLU00079"></a></p>

<h4><a id="sthref220" name="sthref220"></a>To Configure Group Management Service Settings for a Cluster</h4>
<a name="BEGIN" id="BEGIN"></a>
<p>The Group Management Service (GMS) is an in-process service that provides cluster monitoring, cluster membership, and group communication services. The GMS performs the following functions:</p>
<ul>
<li>
<p>Notifies registered modules in a Payara Server instance when one or more member instances are added to or removed from a cluster, or are suspected or confirmed to have failed.</p>
</li>
<li>
<p>Provides the ability to send and receive messages between cluster members.</p>
</li>
</ul>
<ol>
<li>
<p>In the navigation tree, expand the Clusters node.</p>
</li>
<li>
<p>Select the cluster for which you are configuring Group Management Service (GMS) settings.</p>
<p>The General Information page for the cluster opens.</p>
</li>
<li>
<p>Select the GMS Enabled checkbox to enable the GMS for the cluster.</p>
<p>This option is selected by default. To disable the GMS for the cluster, remove the check from the GMS Enabled checkbox.</p>
<p>If enabled, the Group Management Service is started in each server instance in the cluster and in the Domain Administration Server (DAS). The DAS participates in each cluster that has GMS enabled.</p>
</li>
<li>
<p>In the Multicast Port field, type the port the Group Management Service uses to listen for group events.</p>
<p>Specify a standard UDP port number in the range 2048-49151. The default is an automatically generated value in this range.</p>
</li>
<li>
<p>In the Multicast Address field, type the address the Group Management Service uses to listen for group events.</p>
<p>Specify a class D IP multicast address. Class D IP addresses are in the range <code>224.0.0.0</code> to <code>239.255.255.255</code>, inclusive. The address <code>224.0.0.0</code> is reserved and should not be used. The default is 228.9.<i>XX</i>.<i>YY</i>, where <i>XX</i> and <i>YY</i> are automatically generated independent values between 0 and 255.</p>
</li>
<li>
<p>In the Bind Interface Address field, type the network interface address for the Group Management Service if there is more than one network interface.</p>
<p>This setting enables you to configure which network interface is used for the GMS if there is more than one on any of the machines hosting the server instances in the cluster. This value must be a local network interface IP address. By default all public network interface addresses are used.</p>
<p>To specify an address that is valid for all Payara Server instances in the cluster, use a system property to set the address individually for each instance.</p>
<p>For example, create the system property <code>GMS-BIND-INTERFACE-ADDRESS-</code><i>cluster-name</i> on the DAS. Then set this Bind Interface Address option to <code>${GMS-BIND-INTERFACE-ADDRESS-</code><i>cluster-name</i><code>}</code> to specify the system property. Finally, for each instance in the cluster, set the <code>GMS-BIND-INTERFACE-ADDRESS-</code><i>cluster-name</i> system property to the required network interface address on the instance's machine.</p>
</li>
<li>
<p>To specify additional properties, select the Properties tab and the Cluster Properties sub-tab.</p>
<ul>
<li>
<p>To add a property, click the Add Property button. In the blank row that appears, type the property name in the Name field, and type the property value in the Value field.</p>
</li>
<li>
<p>To modify a property, edit that property's Value field.</p>
</li>
<li>
<p>To delete a property, select the checkbox to the left of the Name field of the property that you are deleting, then click the Delete Properties button.</p>
</li>
</ul>
</li>
<li>
<p>Click Save.</p>
</li>
</ol>
<a id="sthref221" name="sthref221"></a>
<h5>See Also</h5>
<ul>
<li>
<p><a href="task-gmsenable.html">To Enable the Group Management Service</a></p>
</li>
<li>
<p><a href="task-gms.html">To Configure the Group Management Service</a></p>
</li>
</ul>


<small>Copyright &#169; 2005, 2017, Oracle and/or its affiliates. All rights reserved. <a href="docinfo.html">Legal Notices</a></small>
<small>Portions Copyright &#169; [2017-2020] Payara Foundation and/or affiliates.</small>
